home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / util / wb / Image2Icon.lha / Image2Icon / Image2Icon.doc next >
Encoding:
Text File  |  2000-07-25  |  5.3 KB  |  162 lines
  1.                     Image2Icon
  2.             © 2000 by Stephan Rupprecht
  3.                 All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  Image2Icon is copyrighted 2000 by Stephan Rupprecht.
  8.  All rights reserved. This program is freeware, so no financial  
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged except for addition of new language catalogs.   
  11.  The author is not responsible for any damage caused by the 
  12.  use or misuse of this documentation and/or the program(s) it 
  13.  describes.
  14.  
  15.  
  16. REQUIREMENTS
  17.  Any Amiga® (compatible) computer with AmigaOS® 3.x,
  18.  newicon.library (for os3.0/3.1 based systems) and 68020+ cpu.
  19.  
  20.  
  21. DESCRIPTION
  22.  Image2Icon is yet another conversion tool that creates thumbnail
  23.  icons from pictures. It supports pictures with any depth, HAM
  24.  images, however, are only supported when picture.datatype v44
  25.  is installed.
  26.  
  27.  
  28. USAGE
  29.  The program can be started from a shell as well as from wb. The
  30.  following options/tooltypes are provided:
  31.  
  32.  FILE/M,MW=MAXWIDTH/N,MH=MAXHEIGHT/N,C=CROP/S,IA=IGNOREASPECT/S,
  33.  AX=ASPECTX/N/K,AY=ASPECTY/N/K,NI=NEWICON/S,FIP=FREEICONPOS/S,
  34.  FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K,T=TRANSPARENT/S,
  35.  OPT=OPTIMIZE/S,FL=FRAMELESS/S,SS=SHOWSIZE/K,F=FONT/K,
  36.  FS=FONTSIZE/N/K,FST=FONTSTYLE/K,AP=APPICON/K,APX=APPICONX/N/K,
  37.  APY=APPICONY/N/K,V42=MOVEV42/S,QU=QUALITY/N/K,P=PLANAR/S,
  38.  MP=MAXPEN/N/K,Q=QUIET/S
  39.  
  40.  FILE/M: the image(s) to convert. If you don't give any, the
  41.   program will add an appicon on which you can drop the pictures
  42.   to convert. By double-clicking the icon the program can be
  43.   terminated.
  44.   
  45.  MW=MAXWIDTH/N,MH=MAXHEIGHT/N: the maximum size of the icon to
  46.   create. Please note that NewIcons are limited to a maximum
  47.   size of 93x93 pixels, os3.5 icons are limited to 256x256 pixels.
  48.   
  49.  C=CROP/S: disables downscaling.
  50.  
  51.  IA=IGNOREASPECT/S: ignore the screen aspect ratio when scaling
  52.   the image. 
  53.  
  54.  AX=ASPECTX/N/K,AY=ASPECTY/N/K: allows you to override the
  55.   screen aspect ratio of the workbench screen.
  56.  
  57.  NI=NEWICON/S: create a NewIcon even when os3.5 is available.
  58.   This option does nothing on a os3.0/os3.1 based system.
  59.  
  60.  FIP=FREEICONPOS/S: the resulting icon doesn't have a fixed
  61.   position.
  62.  
  63.  FW=FRAMEWIDTH/N/K,FH=FRAMEHEIGHT/N/K: allows you to add a
  64.   frame around the image.
  65.   
  66.  T=TRANSPARENT/S: by default, the transparent color (if any) of
  67.   an image is ignored. Thus the resulting icon won't have one
  68.   unless this option is specified. As of 1.2 this option is
  69.   longer working!!!
  70.   
  71.  OPT=OPTIMIZE/S: optimize the image data, if possible (os3.5).
  72.   
  73.  FL=FRAMELESS/S: tell workbench not to draw a border around the
  74.   icon (os3.5).
  75.  
  76.  SS=SHOWSIZE/K: display the image size in the icon. The following
  77.   keywords are recognized:
  78.   
  79.   TOPLEFT,TOPRIGHT,CENTER,BOTTOMLEFT,BOTTOMRIGHT
  80.  
  81.  F=FONT/K: the font that is used by SHOWSIZE.
  82.  
  83.  FS=FONTSIZE/N/K: the size of the font.
  84.  
  85.  FST=FONTSTYLE/K: the style of it, either OUTLINE,SHADOW or 
  86.   NORMAL (default)
  87.  
  88.  AP=APPICON/K: the icon to use as appicon.
  89.  
  90.  APX=APPICONX/N/K,APY=APPICONY/N/K: its position on the workbench
  91.   screen. You always need to specify both.
  92.   
  93.  V42=MODEV42/S: when enabled truecolor images will be converted to
  94.   8bit by the picture.datatype and not by Image2Icon. Requires
  95.   picture.datatype v44!
  96.  
  97.  MP=MAXPENS/N/K: the maximum number of pens to use.
  98.  
  99.  QU=QUALITY/N/K: the quality of the dithering algorithm to use when
  100.   reducing truecolor/HAM images to 8bit.
  101.   
  102.   0 no dithering is done
  103.   1 dither with a 4x4 Bayer matrix (default)
  104.   2 ... 16x16 matrix
  105.   3 Floyd Steinberg
  106.  
  107.  P=PLANAR/S: this will create an "old style" image in addition
  108.   to the os3.5/NewIcon image.
  109.  
  110.  Q=QUIT/S: supresses any output except error messages. Currently
  111.   there's no other output than error messages ;)
  112.  
  113.  
  114. KNOWN PROBLEMS
  115.  - picture.datatype v44 is required to create icons from HAM images.
  116.  - the ilbm.datatype that comes with os3.5 doesn't support bw/greyscale
  117.    images produced by BME (PageStream). Please use my ilbm.datatype
  118.    instead (util/dtype/ilbmdt44.lha).
  119.  - one user reported that the program crashs on very small images,
  120.    I couldn't reproduce this (maybe I already fixed that problem
  121.    without knowing;)
  122.  
  123.  
  124. CREDITS GO TO
  125.  Olaf Barthel who wrote the dithering code used by this program.
  126.  
  127.  
  128. HISTORY
  129.  1.0  first public release
  130.  1.1  added QU=QUALITY/N/K option to select a different dithering
  131.       algorithm. supports HAM images via picture.datatype v44 now.
  132.  1.2  optionally creates a "old style" image in addition to the 
  133.       os3.5/NewIcon one, see PLANAR/S option <John Blyth>. added
  134.       some smoothing code to the scaler, this requires additional
  135.       cpu time but makes the icon look nicer. Please note that I
  136.       had to disable TRANSPARENT/S to make it work correctly. It's
  137.       possible to drop drawers on the icon, now. This will allow
  138.       you to convert a whole dir in one go.
  139.  1.3  some datatypes pass an aspect ratio of 0:0 causing a division
  140.       by zero guru (0x80000005), fixed. When dropping a drawer on
  141.       the appicon the program will no longer put up an error requester
  142.       when encountering an unsupported filetype <John Blyth>. added
  143.       MP=MAXPENS/N/K option although it isn't quite useful (IMHO).
  144.  
  145.  
  146. AUTHOR
  147.  
  148. Please send bug reports and ideas to:
  149.  
  150.  Stephan Rupprecht
  151.  Apfeldweg 1
  152.  D44359 Dortmund
  153.  Germany
  154.  
  155.  Send emails to
  156.  
  157.  info@stephan-rupprecht.de
  158.  
  159.  WWW
  160.  
  161.  http://stephan-rupprecht.de
  162.